<!--
  This file is a part of the open-eBackup project.
  This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.
  If a copy of the MPL was not distributed with this file, You can obtain one at
  http://mozilla.org/MPL/2.0/.
  
  Copyright (c) [2024] Huawei Technologies Co.,Ltd.
  
  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
  EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
  MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
  -->


<!DOCTYPE html
  PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="DC.Type" content="topic">
<meta name="DC.Title" content="Restoring One or Multiple Files in an HDFS Fileset">
<meta name="product" content="">
<meta name="DC.Relation" scheme="URI" content="hdfs_00047_1a.html">
<meta name="prodname" content="">
<meta name="version" content="">
<meta name="brand" content="30-OceanProtect Appliance 1.5.0-1.6.0 Help Center">
<meta name="DC.Publisher" content="20241029">
<meta name="prodname" content="csbs">
<meta name="documenttype" content="usermanual">
<meta name="DC.Format" content="XHTML">
<meta name="DC.Identifier" content="hdfs_00051">
<meta name="DC.Language" content="en-us">
<link rel="stylesheet" type="text/css" href="public_sys-resources/commonltr.css">
<title>Restoring One or Multiple Files in an HDFS Fileset</title>
</head>
<body style="clear:both; padding-left:10px; padding-top:5px; padding-right:5px; padding-bottom:5px"><a name="hdfs_00051"></a><a name="hdfs_00051"></a>

<h1 class="topictitle1">Restoring One or Multiple Files in an HDFS Fileset</h1>
<div><p>This section describes how to restore one or more files or directories in an HDFS fileset.</p>
<div class="section"><h4 class="sectiontitle">Context</h4><p>Data can be restored using a backup copy or an archive copy. File-level restoration is not supported for archive copies of replication copies. File-level restoration using a copy archived to a tape library is not supported. Restoration to the original or a new location is supported.</p>
</div>
<div class="section"><h4 class="sectiontitle">Prerequisites</h4><ul id="hdfs_00051__hdfs_00050_ul29502613113"><li id="hdfs_00051__hdfs_00050_li795172610111">If you need to restore ACL information of HDFS files, ensure that the HDFS ACL configuration has been enabled on the big data platform before the restoration. For details, see <a href="hdfs_00014.html">Step 2: Checking the HDFS ACL Switch Status</a>.</li><li id="hdfs_00051__hdfs_00050_li562133216110">If you need to restore ACL information of HDFS files, you must have HDFS super user permissions. The user is configured in <a href="hdfs_00015.html">Step 3: Registering an HDFS Cluster</a>.</li></ul>
</div>
<div class="section"><h4 class="sectiontitle">Procedure</h4><ol><li><span>Choose <span class="uicontrol" id="hdfs_00051__hdfs_00047_en-us_topic_0000001839142377_uicontrol317519513496"><b><span id="hdfs_00051__hdfs_00047_en-us_topic_0000001839142377_text16175459497"><strong>Explore</strong></span> &gt; <span id="hdfs_00051__hdfs_00047_en-us_topic_0000001839142377_text1017555104914"><strong>Copy Data</strong></span> &gt; <span id="hdfs_00051__hdfs_00047_en-us_topic_0000001839142377_text1483910189532"><strong>Big Data</strong></span> &gt; HDFS</b></span>.</span></li><li><span>You can search for copies by HDFS fileset resource or copy. This section describes how to search for copies by resource.</span><p><p>On the <strong>Resources</strong> tab page, locate the fileset to be restored based on the fileset name and click the fileset name.</p>
</p></li><li><span>Click <span class="uicontrol"><b><span><strong>Copy Data</strong></span></b></span> and select the year, month, and day in sequence to locate the copy.</span><p><p>If <span><img src="en-us_image_0000001839276429.png"></span> is displayed below a month or day, a copy is generated in that month or day.</p>
</p></li><li><span>In the row where the copy resides, choose <span class="uicontrol"><b><span><strong>More</strong></span> &gt; <span><strong>File-level Restoration</strong></span></b></span>.</span><p><div class="note"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul><li>The index status of the copy used for file-level restoration must be <span class="uicontrol"><b><span><strong>Indexed</strong></span></b></span>. If the index status is <span class="uicontrol"><b><span><strong>Not indexed</strong></span></b></span>, choose <span class="uicontrol"><b><span><strong>More</strong></span> &gt; <span><strong>Manually Create Index</strong></span></b></span> to create an index for the copy.</li><li>File-level restoration is not supported for linked files.</li></ul>
</div></div>
</p></li><li><span>Select the files to be restored, and click <span class="uicontrol"><b>Select</b></span> on the right of <span class="uicontrol"><b>Target Restoration Location</b></span>.</span><p><ul><li>For 1.5.0, select the files to be restored from the directory tree.</li><li>For 1.6.0 and later versions, set <strong>File Obtaining Mode</strong>, which can be <strong>Select file paths from the directory tree</strong> or <strong>Enter file paths</strong>.<div class="note"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul><li>If the copy contains too many files, the system may time out, preventing you from selecting files to be restored from the directory tree. Therefore, you are advised to enter the paths of files to be restored.</li><li>When entering a file path, enter a complete file path, for example, <strong>/opt/abc/efg.txt</strong> or <strong>C:\abc\efg.txt</strong>. If you enter a folder path, for example, <strong>/opt/abc</strong> or <strong>C:\abc</strong>, all files in the folder are restored. The file name in the path is case sensitive.</li></ul>
</div></div>
</li></ul>
</p></li><li><span>On the displayed <strong>Select Target Restoration Location</strong> page, select <strong>Original location</strong> or <strong>New location</strong> for <strong>Restore To</strong> and set restoration parameters. <a href="#hdfs_00051__table175551511133610">Table 1</a> lists the related parameters.</span><p>
<div class="tablenoborder"><a name="hdfs_00051__table175551511133610"></a><a name="table175551511133610"></a><table cellpadding="4" cellspacing="0" summary="" id="hdfs_00051__table175551511133610" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters for restoring files</caption><colgroup><col style="width:23.09%"><col style="width:76.91%"></colgroup><thead align="left"><tr><th align="left" class="cellrowborder" valign="top" width="23.09%" id="mcps1.3.4.2.6.2.1.2.3.1.1"><p>Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="76.91%" id="mcps1.3.4.2.6.2.1.2.3.1.2"><p>Description</p>
</th>
</tr>
</thead>
<tbody><tr><td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.6.2.1.2.3.1.1 "><p><span><strong>Restore To</strong></span></p>
</td>
<td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.6.2.1.2.3.1.2 "><p>Restore the file to the original location or a new location.</p>
<ul><li><span><strong>Original location</strong></span>: Restore the file to the original HDFS cluster.</li><li><span><strong>New location</strong></span>: Restore the file to a new location. You must specify the target HDFS cluster and path.</li></ul>
</td>
</tr>
<tr><td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.6.2.1.2.3.1.1 "><p><span><strong>Target Cluster</strong></span></p>
</td>
<td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.6.2.1.2.3.1.2 "><p>When the file is restored to a new location, you must specify the target HDFS cluster, which can be the original cluster or another cluster added to the <span>OceanProtect</span>.</p>
</td>
</tr>
<tr><td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.6.2.1.2.3.1.1 "><p><span><strong>Path</strong></span></p>
</td>
<td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.6.2.1.2.3.1.2 "><p>When the file is restored to a new location, you must specify the path for the restoration.</p>
</td>
</tr>
<tr><td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.6.2.1.2.3.1.1 "><p><span><strong>Please select</strong></span></p>
</td>
<td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.6.2.1.2.3.1.2 "><p>If files with the same names exist in the restoration path, you can select either of the following:</p>
<ul><li><span><strong>Skip existing files</strong></span>: Files with the same names are skipped and are not replaced.</li><li><span><strong>Replace existing files</strong></span></li></ul>
</td>
</tr>
<tr><td class="cellrowborder" valign="top" width="23.09%" headers="mcps1.3.4.2.6.2.1.2.3.1.1 "><p id="hdfs_00051__p1732518217143"><strong id="hdfs_00051__b1684105921110">Remaining Capacity Threshold of Production Storage</strong></p>
<div class="note" id="hdfs_00051__note56661924132910"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="hdfs_00051__p36661248295">This parameter is available only in 1.6.RC2 and later versions.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="76.91%" headers="mcps1.3.4.2.6.2.1.2.3.1.2 "><p id="hdfs_00051__p1325152161411">During backup or restoration, the Hadoop snapshot technology occupies production storage space, and you need to properly configure this parameter. If the percentage of the remaining capacity of the production storage is less than the threshold, backup or restoration jobs cannot be triggered.</p>
</td>
</tr>
</tbody>
</table>
</div>
</p></li><li><span>Click <span class="uicontrol"><b>OK</b></span>.</span></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="hdfs_00047_1a.html">Restoration</a></div>
</div>
</div>

<div class="hrcopyright"><hr size="2"></div><div class="hwcopyright">Copyright &copy; Huawei Technologies Co., Ltd.</div></body>
</html>